Root.setPersons - Code Metrics - rootsdev/gedcomx-js - Measure and Improve Code Quality continuously with Scrutinizer

Root.setPersons A
last analyzed 2017-03-29 00:20 UTC

↳ Parent: src/core/Root.js

Complexity

Conditions	1
Paths	1

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	1
c	1
b	0
f	0
nc	1
nop	1
dl	0
loc	3
rs	10

var utils = require('../utils'),
    GedcomX = require('../');

/**
 * A GEDCOM X document.
 * 
 * @see {@link https://github.com/FamilySearch/gedcomx/blob/master/specifications/json-format-specification.md#gedcomx-type|GEDCOM X JSON Spec}
 * 
 * @class
 * @extends ExtensibleData
 * @param {Object} [json]
 */
var Root = function(json){
  
  // Protect against forgetting the new keyword when calling the constructor
  if(!(this instanceof Root)){
    return new Root(json);
  }
  
  // If the given object is already an instance then just return it. DON'T copy it.
  if(Root.isInstance(json)){
    return json;
  }
  
  this.init(json);

};

Root.prototype = Object.create(GedcomX.ExtensibleData.prototype);

Root._gedxClass = Root.prototype._gedxClass = 'Root';

Root.jsonProps = [
  'lang',
  'description',
  'persons',
  'relationships',
  'sourceDescriptions',
  'agents',
  'events',
  'documents',
  'places',
  'attribution'
];

/**
 * Check whether the given object is an instance of this class.
 * 
 * @param {Object} obj
 * @returns {Boolean}
 */
Root.isInstance = function(obj){
  return utils.isInstance(obj, this._gedxClass);
};

/**
 * Initialize from JSON
 * 
 * @param {Object}

 * @return {Root} this
 */
Root.prototype.init = function(json){
  
  GedcomX.ExtensibleData.prototype.init.call(this, json);
  
  if(json){
    this.setLang(json.lang);
    this.setPersons(json.persons);
    this.setRelationships(json.relationships);
    this.setSourceDescriptions(json.sourceDescriptions);
    this.setAgents(json.agents);
    this.setEvents(json.events);
    this.setDocuments(json.documents);
    this.setPlaces(json.places);
    this.setAttribution(json.attribution);
    this.setDescription(json.description);
  }
  return this;
};

/**
 * Get the lang
 * 
 * @return {String}
 */
Root.prototype.getLang = function(){
  return this.lang;
};

/**
 * Set the lang
 * 
 * @param {String} lang
 * @return {Root} This instance
 */
Root.prototype.setLang = function(lang){
  if(lang){
    this.lang = lang;
  }
  return this;
};

/**
 * Get the description
 * 
 * @return {String}
 */
Root.prototype.getDescription = function(){
  return this.description;
};

/**
 * Set the description
 * 
 * @param {String} description URI that must resolve to a SourceDescription
 * @return {Root} This instance
 */
Root.prototype.setDescription = function(description){
  if(description){
    this.description = description;
  }
  return this;
};

/**
 * Get the persons
 * 
 * @returns {Person[]}
 */
Root.prototype.getPersons = function(){
  return this.persons || [];
};

/**
 * Set the persons
 * 
 * @param {Person[]|Object[]} persons
 * @returns {Root} This instance
 */
Root.prototype.setPersons = function(persons){
  return this._setArray(persons, 'persons', 'addPerson');
};

/**
 * Add a person
 * 
 * @param {Person|Object}

 * @returns {Root} This instance
 */
Root.prototype.addPerson = function(person){
  return this._arrayPush(person, 'persons', GedcomX.Person);
};

/**
 * Get the person matching a given ID.
 * 
 * @param {String|Integer} id Person ID
 * @return {Person} Person matching the given ID.
 */
Root.prototype.getPersonById = function(id){
  return this.getPersons().find(function(p){
    return p.getId() === id;
  });
};

/**
 * Get all relationships
 * 
 * @returns {Relationship[]}
 */
Root.prototype.getRelationships = function(){
  return this.relationships || [];
};

/**
 * Get the relationships involving a specific person
 * 
 * @param {Person|String} person Person or person ID
 * @return {Relationship[]} Person's relationships.
 */
Root.prototype.getPersonsRelationships = function(person){
  return this.getRelationships().filter(function(rel){
    return rel.involvesPerson(person);
  });
};

/**
 * Get a person's parent relationships, meaning relationships where the person
 * is a child (relationships with their parents).
 * 
 * @param {Person|String} person Person or person ID
 * @return {Relationship[]}
 */
Root.prototype.getPersonsParentRelationships = function(person){
  return this.getPersonsRelationships(person).filter(function(rel){
    return rel.getType() === 'http://gedcomx.org/ParentChild' && rel.getPerson2().matches(person);
  });
};

/**
 * Get a person's parents.
 * 
 * @param {Person|String} person Person or person ID
 * @return {Person[]}
 */
Root.prototype.getPersonsParents = function(person){
  var root = this;
  return this.getPersonsParentRelationships(person).map(function(rel){
    return root.getPersonById(rel.getPerson1().getResource().substring(1));
  })
  
  // Remove any falsy values from the array. That can happen if the rel -> person
  // mapping fails to find a matching person.
  .filter(Boolean);
};

/**
 * Get a person's couple relationships.
 * 
 * @param {Person|String} person Person or person ID
 * @return {Relationship[]}
 */
Root.prototype.getPersonsCoupleRelationships = function(person){
  return this.getPersonsRelationships(person).filter(function(rel){
    return rel.getType() === 'http://gedcomx.org/Couple';
  });
};

/**
 * Get a person's spouses.
 * 
 * @param {Person|String} person Person or person ID
 * @return {Person[]}
 */
Root.prototype.getPersonsSpouses = function(person){
  var root = this;
  return this.getPersonsCoupleRelationships(person).map(function(rel){
    return root.getPersonById(rel.getOtherPerson(person).getResource().substring(1));
  })
  
  // Remove any falsy values from the array. That can happen if the rel -> person
  // mapping fails to find a matching person.
  .filter(Boolean);
};

/**
 * Get a person's child relationships, meaning relationships where the person
 * is a parent (relationships with their children).
 * 
 * @param {Person|String} person Person or person ID
 * @return {Relationship[]}
 */
Root.prototype.getPersonsChildRelationships = function(person){
  return this.getPersonsRelationships(person).filter(function(rel){
    return rel.getType() === 'http://gedcomx.org/ParentChild' && rel.getPerson1().matches(person);
  });
};

/**
 * Get a person's children.
 * 
 * @param {Person|String} person Person or person ID
 * @return {Person[]}
 */
Root.prototype.getPersonsChildren = function(person){
  var root = this;
  return this.getPersonsChildRelationships(person).map(function(rel){
    return root.getPersonById(rel.getPerson2().getResource().substring(1));
  })
  
  // Remove any falsy values from the array. That can happen if the rel -> person
  // mapping fails to find a matching person.
  .filter(Boolean);
};

/**
 * Set the relationships
 * 
 * @param {Relationship[]|Object[]} relationships
 * @returns {Root}
 */
Root.prototype.setRelationships = function(relationships){
  return this._setArray(relationships, 'relationships', 'addRelationship');
};

/**
 * Add a relationship
 * 
 * @param {Relationship|Object} relationship
 * @returns {Root}
 */
Root.prototype.addRelationship = function(relationship){
  return this._arrayPush(relationship, 'relationships', GedcomX.Relationship);
};

/**
 * Get the source descriptions
 * 
 * @returns {SourceDescription[]}
 */
Root.prototype.getSourceDescriptions = function(){
  return this.sourceDescriptions || [];
};

/**
 * Set the source descriptions
 * 
 * @param {SourceDescription[]|Object[]} sourceDescriptions
 * @returns {Root}
 */
Root.prototype.setSourceDescriptions = function(sourceDescriptions){
  return this._setArray(sourceDescriptions, 'sourceDescriptions', 'addSourceDescription');
};

/**
 * Add a ource description
 * 
 * @param {SourceDescription|Object} sourceDescription
 * @returns {Root}
 */
Root.prototype.addSourceDescription = function(sourceDescription){
  return this._arrayPush(sourceDescription, 'sourceDescriptions', GedcomX.SourceDescription);
};

/**
 * Get the agents
 * 
 * @returns {Agent[]}
 */
Root.prototype.getAgents = function(){
  return this.agents || [];
};

/**
 * Set the agents
 * 
 * @param {Agent[]|Object[]} agents
 * @returns {Root}
 */
Root.prototype.setAgents = function(agents){
  return this._setArray(agents, 'agents', 'addAgent');
};

/**
 * Add an agent
 * 
 * @param {Agent|Object}

 * @returns {Root}
 */
Root.prototype.addAgent = function(agent){
  return this._arrayPush(agent, 'agents', GedcomX.Agent);
};

/**
 * Get events
 * 
 * @returns {Event[]}
 */
Root.prototype.getEvents = function(){
  return this.events || [];
};

/**
 * Set events
 * 
 * @param {Event[]|Object[]} events
 * @returns {Root}
 */
Root.prototype.setEvents = function(events){
  return this._setArray(events, 'events', 'addEvent');
};

/**
 * Add an event
 * 
 * @param {Event|Object} event
 * @returns {Root}
 */
Root.prototype.addEvent = function(event){
  return this._arrayPush(event, 'events', GedcomX.Event);
};

/**
 * Get the documents
 * 
 * @returns {Document[]}
 */
Root.prototype.getDocuments = function(){
  return this.documents || [];
};

/**
 * Set the documents
 * 
 * @param {Documents[]|Object[]} documents
 * @returns {Root}
 */
Root.prototype.setDocuments = function(documents){
  return this._setArray(documents, 'documents', 'addDocument');
};

/**
 * Add a document
 * 
 * @param {Document|Object} doc
 * @returns {Root}
 */
Root.prototype.addDocument = function(doc){
  return this._arrayPush(doc, 'documents', GedcomX.Document);
};

/**
 * Get places
 * 
 * @returns {PlaceDescription[]}
 */
Root.prototype.getPlaces = function(){
  return this.places || [];
};

/**
 * Set the places
 * 
 * @param {PlaceDescription[]|Object} places
 * @returns {Root}
 */
Root.prototype.setPlaces = function(places){
  return this._setArray(places, 'places', 'addPlace');
};

/**
 * Add a place
 * 
 * @param {PlaceDescription} place
 * @returns {Root}
 */
Root.prototype.addPlace = function(place){
  return this._arrayPush(place, 'places', GedcomX.PlaceDescription);
};

/**
 * Get attritbution
 * 
 * @returns {Attribution}
 */
Root.prototype.getAttribution = function(){
  return this.attribution;
};

/**
 * Set attribution
 * 
 * @param {Attribution} attribution
 * @returns {Root}
 */
Root.prototype.setAttribution = function(attribution){
  if(attribution){
    this.attribution = GedcomX.Attribution(attribution);
  }
  return this;
};

/**
 * Export the object as JSON
 * 
 * @return {Object} JSON object
 */
Root.prototype.toJSON = function(){
  return this._toJSON(GedcomX.ExtensibleData, Root.jsonProps);
};

module.exports = Root;

1			var utils = require('../utils'),
2			GedcomX = require('../');
3
4			/**
5			* A GEDCOM X document.
6			*
7			* @see {@link https://github.com/FamilySearch/gedcomx/blob/master/specifications/json-format-specification.md#gedcomx-type\|GEDCOM X JSON Spec}
8			*
9			* @class
10			* @extends ExtensibleData
11			* @param {Object} [json]
12			*/
13			var Root = function(json){
14
15			// Protect against forgetting the new keyword when calling the constructor
16			if(!(this instanceof Root)){
17			return new Root(json);
18			}
19
20			// If the given object is already an instance then just return it. DON'T copy it.
21			if(Root.isInstance(json)){
22			return json;
23			}
24
25			this.init(json);
			0 ignored issues – show Best Practice introduced 2016-10-06 21:41 UTC by Report Bug Copy Issue Report There is no `return` statement in this branch, but you do return something in other branches. Did you maybe miss it? If you do not want to return anything, consider adding `return undefined;` explicitly. Loading history...
26			};
27
28			Root.prototype = Object.create(GedcomX.ExtensibleData.prototype);
29
30			Root._gedxClass = Root.prototype._gedxClass = 'Root';
31
32			Root.jsonProps = [
33			'lang',
34			'description',
35			'persons',
36			'relationships',
37			'sourceDescriptions',
38			'agents',
39			'events',
40			'documents',
41			'places',
42			'attribution'
43			];
44
45			/**
46			* Check whether the given object is an instance of this class.
47			*
48			* @param {Object} obj
49			* @returns {Boolean}
50			*/
51			Root.isInstance = function(obj){
52			return utils.isInstance(obj, this._gedxClass);
53			};
54
55			/**
56			* Initialize from JSON
57			*
58			* @param {Object}
			0 ignored issues – show Documentation introduced 2016-10-06 21:41 UTC by Report Bug Copy Issue Report The parameter `*` does not exist. Did you maybe forget to remove this comment? Loading history...
59			* @return {Root} this
60			*/
61			Root.prototype.init = function(json){
62
63			GedcomX.ExtensibleData.prototype.init.call(this, json);
64
65			if(json){
66			this.setLang(json.lang);
67			this.setPersons(json.persons);
68			this.setRelationships(json.relationships);
69			this.setSourceDescriptions(json.sourceDescriptions);
70			this.setAgents(json.agents);
71			this.setEvents(json.events);
72			this.setDocuments(json.documents);
73			this.setPlaces(json.places);
74			this.setAttribution(json.attribution);
75			this.setDescription(json.description);
76			}
77			return this;
78			};
79
80			/**
81			* Get the lang
82			*
83			* @return {String}
84			*/
85			Root.prototype.getLang = function(){
86			return this.lang;
87			};
88
89			/**
90			* Set the lang
91			*
92			* @param {String} lang
93			* @return {Root} This instance
94			*/
95			Root.prototype.setLang = function(lang){
96			if(lang){
97			this.lang = lang;
98			}
99			return this;
100			};
101
102			/**
103			* Get the description
104			*
105			* @return {String}
106			*/
107			Root.prototype.getDescription = function(){
108			return this.description;
109			};
110
111			/**
112			* Set the description
113			*
114			* @param {String} description URI that must resolve to a SourceDescription
115			* @return {Root} This instance
116			*/
117			Root.prototype.setDescription = function(description){
118			if(description){
119			this.description = description;
120			}
121			return this;
122			};
123
124			/**
125			* Get the persons
126			*
127			* @returns {Person[]}
128			*/
129			Root.prototype.getPersons = function(){
130			return this.persons \|\| [];
131			};
132
133			/**
134			* Set the persons
135			*
136			* @param {Person[]\|Object[]} persons
137			* @returns {Root} This instance
138			*/
139			Root.prototype.setPersons = function(persons){
140			return this._setArray(persons, 'persons', 'addPerson');
141			};
142
143			/**
144			* Add a person
145			*
146			* @param {Person\|Object}
			0 ignored issues – show Documentation introduced 2016-05-27 14:53 UTC by Report Bug Copy Issue Report The parameter `*` does not exist. Did you maybe forget to remove this comment? Loading history...
147			* @returns {Root} This instance
148			*/
149			Root.prototype.addPerson = function(person){
150			return this._arrayPush(person, 'persons', GedcomX.Person);
151			};
152
153			/**
154			* Get the person matching a given ID.
155			*
156			* @param {String\|Integer} id Person ID
157			* @return {Person} Person matching the given ID.
158			*/
159			Root.prototype.getPersonById = function(id){
160			return this.getPersons().find(function(p){
161			return p.getId() === id;
162			});
163			};
164
165			/**
166			* Get all relationships
167			*
168			* @returns {Relationship[]}
169			*/
170			Root.prototype.getRelationships = function(){
171			return this.relationships \|\| [];
172			};
173
174			/**
175			* Get the relationships involving a specific person
176			*
177			* @param {Person\|String} person Person or person ID
178			* @return {Relationship[]} Person's relationships.
179			*/
180			Root.prototype.getPersonsRelationships = function(person){
181			return this.getRelationships().filter(function(rel){
182			return rel.involvesPerson(person);
183			});
184			};
185
186			/**
187			* Get a person's parent relationships, meaning relationships where the person
188			* is a child (relationships with their parents).
189			*
190			* @param {Person\|String} person Person or person ID
191			* @return {Relationship[]}
192			*/
193			Root.prototype.getPersonsParentRelationships = function(person){
194			return this.getPersonsRelationships(person).filter(function(rel){
195			return rel.getType() === 'http://gedcomx.org/ParentChild' && rel.getPerson2().matches(person);
196			});
197			};
198
199			/**
200			* Get a person's parents.
201			*
202			* @param {Person\|String} person Person or person ID
203			* @return {Person[]}
204			*/
205			Root.prototype.getPersonsParents = function(person){
206			var root = this;
207			return this.getPersonsParentRelationships(person).map(function(rel){
208			return root.getPersonById(rel.getPerson1().getResource().substring(1));
209			})
210
211			// Remove any falsy values from the array. That can happen if the rel -> person
212			// mapping fails to find a matching person.
213			.filter(Boolean);
214			};
215
216			/**
217			* Get a person's couple relationships.
218			*
219			* @param {Person\|String} person Person or person ID
220			* @return {Relationship[]}
221			*/
222			Root.prototype.getPersonsCoupleRelationships = function(person){
223			return this.getPersonsRelationships(person).filter(function(rel){
224			return rel.getType() === 'http://gedcomx.org/Couple';
225			});
226			};
227
228			/**
229			* Get a person's spouses.
230			*
231			* @param {Person\|String} person Person or person ID
232			* @return {Person[]}
233			*/
234			Root.prototype.getPersonsSpouses = function(person){
235			var root = this;
236			return this.getPersonsCoupleRelationships(person).map(function(rel){
237			return root.getPersonById(rel.getOtherPerson(person).getResource().substring(1));
238			})
239
240			// Remove any falsy values from the array. That can happen if the rel -> person
241			// mapping fails to find a matching person.
242			.filter(Boolean);
243			};
244
245			/**
246			* Get a person's child relationships, meaning relationships where the person
247			* is a parent (relationships with their children).
248			*
249			* @param {Person\|String} person Person or person ID
250			* @return {Relationship[]}
251			*/
252			Root.prototype.getPersonsChildRelationships = function(person){
253			return this.getPersonsRelationships(person).filter(function(rel){
254			return rel.getType() === 'http://gedcomx.org/ParentChild' && rel.getPerson1().matches(person);
255			});
256			};
257
258			/**
259			* Get a person's children.
260			*
261			* @param {Person\|String} person Person or person ID
262			* @return {Person[]}
263			*/
264			Root.prototype.getPersonsChildren = function(person){
265			var root = this;
266			return this.getPersonsChildRelationships(person).map(function(rel){
267			return root.getPersonById(rel.getPerson2().getResource().substring(1));
268			})
269
270			// Remove any falsy values from the array. That can happen if the rel -> person
271			// mapping fails to find a matching person.
272			.filter(Boolean);
273			};
274
275			/**
276			* Set the relationships
277			*
278			* @param {Relationship[]\|Object[]} relationships
279			* @returns {Root}
280			*/
281			Root.prototype.setRelationships = function(relationships){
282			return this._setArray(relationships, 'relationships', 'addRelationship');
283			};
284
285			/**
286			* Add a relationship
287			*
288			* @param {Relationship\|Object} relationship
289			* @returns {Root}
290			*/
291			Root.prototype.addRelationship = function(relationship){
292			return this._arrayPush(relationship, 'relationships', GedcomX.Relationship);
293			};
294
295			/**
296			* Get the source descriptions
297			*
298			* @returns {SourceDescription[]}
299			*/
300			Root.prototype.getSourceDescriptions = function(){
301			return this.sourceDescriptions \|\| [];
302			};
303
304			/**
305			* Set the source descriptions
306			*
307			* @param {SourceDescription[]\|Object[]} sourceDescriptions
308			* @returns {Root}
309			*/
310			Root.prototype.setSourceDescriptions = function(sourceDescriptions){
311			return this._setArray(sourceDescriptions, 'sourceDescriptions', 'addSourceDescription');
312			};
313
314			/**
315			* Add a ource description
316			*
317			* @param {SourceDescription\|Object} sourceDescription
318			* @returns {Root}
319			*/
320			Root.prototype.addSourceDescription = function(sourceDescription){
321			return this._arrayPush(sourceDescription, 'sourceDescriptions', GedcomX.SourceDescription);
322			};
323
324			/**
325			* Get the agents
326			*
327			* @returns {Agent[]}
328			*/
329			Root.prototype.getAgents = function(){
330			return this.agents \|\| [];
331			};
332
333			/**
334			* Set the agents
335			*
336			* @param {Agent[]\|Object[]} agents
337			* @returns {Root}
338			*/
339			Root.prototype.setAgents = function(agents){
340			return this._setArray(agents, 'agents', 'addAgent');
341			};
342
343			/**
344			* Add an agent
345			*
346			* @param {Agent\|Object}
			0 ignored issues – show Documentation introduced 2016-05-27 14:53 UTC by Report Bug Copy Issue Report The parameter `*` does not exist. Did you maybe forget to remove this comment? Loading history...
347			* @returns {Root}
348			*/
349			Root.prototype.addAgent = function(agent){
350			return this._arrayPush(agent, 'agents', GedcomX.Agent);
351			};
352
353			/**
354			* Get events
355			*
356			* @returns {Event[]}
357			*/
358			Root.prototype.getEvents = function(){
359			return this.events \|\| [];
360			};
361
362			/**
363			* Set events
364			*
365			* @param {Event[]\|Object[]} events
366			* @returns {Root}
367			*/
368			Root.prototype.setEvents = function(events){
369			return this._setArray(events, 'events', 'addEvent');
370			};
371
372			/**
373			* Add an event
374			*
375			* @param {Event\|Object} event
376			* @returns {Root}
377			*/
378			Root.prototype.addEvent = function(event){
379			return this._arrayPush(event, 'events', GedcomX.Event);
380			};
381
382			/**
383			* Get the documents
384			*
385			* @returns {Document[]}
386			*/
387			Root.prototype.getDocuments = function(){
388			return this.documents \|\| [];
389			};
390
391			/**
392			* Set the documents
393			*
394			* @param {Documents[]\|Object[]} documents
395			* @returns {Root}
396			*/
397			Root.prototype.setDocuments = function(documents){
398			return this._setArray(documents, 'documents', 'addDocument');
399			};
400
401			/**
402			* Add a document
403			*
404			* @param {Document\|Object} doc
405			* @returns {Root}
406			*/
407			Root.prototype.addDocument = function(doc){
408			return this._arrayPush(doc, 'documents', GedcomX.Document);
409			};
410
411			/**
412			* Get places
413			*
414			* @returns {PlaceDescription[]}
415			*/
416			Root.prototype.getPlaces = function(){
417			return this.places \|\| [];
418			};
419
420			/**
421			* Set the places
422			*
423			* @param {PlaceDescription[]\|Object} places
424			* @returns {Root}
425			*/
426			Root.prototype.setPlaces = function(places){
427			return this._setArray(places, 'places', 'addPlace');
428			};
429
430			/**
431			* Add a place
432			*
433			* @param {PlaceDescription} place
434			* @returns {Root}
435			*/
436			Root.prototype.addPlace = function(place){
437			return this._arrayPush(place, 'places', GedcomX.PlaceDescription);
438			};
439
440			/**
441			* Get attritbution
442			*
443			* @returns {Attribution}
444			*/
445			Root.prototype.getAttribution = function(){
446			return this.attribution;
447			};
448
449			/**
450			* Set attribution
451			*
452			* @param {Attribution} attribution
453			* @returns {Root}
454			*/
455			Root.prototype.setAttribution = function(attribution){
456			if(attribution){
457			this.attribution = GedcomX.Attribution(attribution);
458			}
459			return this;
460			};
461
462			/**
463			* Export the object as JSON
464			*
465			* @return {Object} JSON object
466			*/
467			Root.prototype.toJSON = function(){
468			return this._toJSON(GedcomX.ExtensibleData, Root.jsonProps);
469			};
470
471			module.exports = Root;

rootsdev / gedcomx-js

Root.setPersons A last analyzed 2017-03-29 00:20 UTC

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like

Root.setPersons A
last analyzed 2017-03-29 00:20 UTC